Transfer

Create a meta-transaction message payload to transfer voucher balances.

Related Queries

• User Balance: Use this query to fetch the sender's available voucher balances before constructing the transfer.
• Unified User Balance: Use this query if you need voucher balances across multiple chains before selecting the transfer source.
• All Chains: Use this query to fetch valid destination chain UIDs for recipient destinations. In most integrations, from.chain_uid and sender.chain_uid are derived from the connected wallet or source chain context.

Request URL

https://api.euclidprotocol.com/api/v1/execute/meta-txn/transfer

Example

curl -X 'POST'   'https://api.euclidprotocol.com/api/v1/execute/meta-txn/transfer'   -H 'accept: application/json'   -H 'Content-Type: application/json'   -d '{
  "amount": "1000000",
  "from": {
    "address": "0x887e4aac216674d2c432798f851c1ea5d505b2e1",
    "chain_uid": "monad"
  },
  "recipient_address": {
    "address": "0x5abfe1234567890cdefabc1234567890defabc01",
    "chain_uid": "0g"
  },
  "sender": {
    "address": "0x887e4aac216674d2c432798f851c1ea5d505b2e1",
    "chain_uid": "monad"
  },
  "timeout": "60",
  "token": "euclid"
}'

{
  "msg": {
    "target": "euclid1yvgh8xeju5dyr0zxlkvq09htvhjj20fncp5g58np4u25g8rkpgjsy5hngy",
    "call_data": "{"transfer_voucher":{...}}"
  },
  "type": "transfer_voucher",
  "token_in": "",
  "token_out": "",
  "token": "euclid",
  "amount_in": "1000000",
  "amount_out": ""
}

Parameters

Field	Type	Description
amount	string	Amount of voucher tokens to transfer.
token	string	Voucher token identifier.
from	CrossChainUserWithAmount	Source user and chain for the voucher balance.
sender	CrossChainUserWithAmount	Address and chain initiating the meta transaction.
recipient_address	CrossChainUserWithAmount	Recipient user and chain for this transfer request.
msg	string	Optional message payload to include with the transfer.
timeout	string	Optional timeout in seconds.

Response Fields

Field	Type	Description
msg.target	string	Router contract address that will receive the message.
msg.call_data	string	Encoded contract call data.
type	string	Transaction type (transfer_voucher).
token	string	Token identifier for this meta message.
amount_in	string	Input amount tracked for this meta message.